feat(runtime-core): add import-map remote entry support by ScriptedAlchemy · Pull Request #4390 · module-federation/core

ScriptedAlchemy · 2026-02-08T22:31:39Z

Summary

add import-map based remote entry support in runtime-core
wire shared import handling to honor import configuration with dynamic import flows
expose disableImportMap optimization options through enhanced/rspack/sdk plugin surfaces
include docs and runnable import-map app examples for verification

Changed Packages

@module-federation/runtime-core
@module-federation/enhanced
@module-federation/rspack
@module-federation/sdk

Changesets

.changeset/clean-cobras-rest.md (patch for all listed packages)

Base

main

Single-PR Review Guide (No Additional PRs)

This PR will remain a single PR. Improvements are being done in-place (no stacked or follow-up PR splitting).

Suggested Review Order

Core behavior/runtime changes first.
Build/tooling and workflow updates second.
Docs/examples/app fixtures last.

In-Place Scope Trim Checklist

Remove unrelated churn not required for this PR goal.
Keep lockfile and generated changes only when strictly needed.
Confirm acceptance criteria and regression tests are explicit in this PR.
Resolve merge conflict status and required CI checks before final re-review.

cursor · 2026-02-08T22:31:40Z

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
_{Learn more about Cursor Agents}

netlify · 2026-02-08T22:31:44Z

✅ Deploy Preview for module-federation-docs ready!

Name	Link
🔨 Latest commit	`0a0c44c`
🔍 Latest deploy log	https://app.netlify.com/projects/module-federation-docs/deploys/69b05fa172fb4a00088a90bc
😎 Deploy Preview	https://deploy-preview-4390--module-federation-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

changeset-bot · 2026-02-08T22:31:46Z

🦋 Changeset detected

Latest commit: 0a0c44c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 45 packages

Name	Type
@module-federation/runtime-core	Patch
@module-federation/enhanced	Patch
@module-federation/rspack	Patch
@module-federation/sdk	Patch
@module-federation/runtime	Patch
@module-federation/bridge-react	Patch
@module-federation/modern-js-v3	Patch
@module-federation/modern-js	Patch
@module-federation/nextjs-mf	Patch
@module-federation/node	Patch
@module-federation/rsbuild-plugin	Patch
@module-federation/rspress-plugin	Patch
@module-federation/storybook-addon	Patch
shared-tree-shaking-no-server-host	Patch
shared-tree-shaking-no-server-provider	Patch
@module-federation/devtools	Patch
@module-federation/cli	Patch
@module-federation/data-prefetch	Patch
@module-federation/dts-plugin	Patch
@module-federation/esbuild	Patch
@module-federation/managers	Patch
@module-federation/manifest	Patch
@module-federation/metro	Patch
@module-federation/retry-plugin	Patch
@module-federation/utilities	Patch
@module-federation/webpack-bundler-runtime	Patch
@module-federation/bridge-react-webpack-plugin	Patch
@module-federation/bridge-vue3	Patch
@module-federation/runtime-tools	Patch
shared-tree-shaking-with-server-host	Patch
shared-tree-shaking-with-server-provider	Patch
node-dynamic-remote-new-version	Patch
node-dynamic-remote	Patch
remote5	Patch
remote6	Patch
website-new	Patch
@module-federation/metro-plugin-rnc-cli	Patch
@module-federation/metro-plugin-rnef	Patch
@module-federation/inject-external-runtime-core-plugin	Patch
@module-federation/third-party-dts-extractor	Patch
@module-federation/bridge-shared	Patch
@module-federation/error-codes	Patch
create-module-federation	Patch
@module-federation/treeshake-server	Patch
@module-federation/treeshake-frontend	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

github-actions · 2026-02-08T22:53:30Z

Bundle Size Report

10 package(s) changed, 31 unchanged.

Package	Total dist	Delta	ESM gzip	Delta
`runtime-core`	252.1 kB	+2.8 kB (+1.1%)	477 B	no change
`vue3-bridge`	142.2 kB	+1.6 kB (+1.1%)	21.8 kB	+280 B (+1.3%)
`enhanced`	840.4 kB	+862 B (+0.1%)	712 B	no change
`rspack`	59.3 kB	+750 B (+1.2%)	211 B	no change
`bridge-react`	358.2 kB	+591 B (+0.2%)	1.3 kB	-3 B (-0.2%)
`webpack-bundler-runtime`	88.7 kB	+208 B (+0.2%)	405 B	no change
`dts-plugin`	298.0 kB	+170 B (+0.1%)	4.3 kB	no change
`retry-plugin`	61.2 kB	+170 B (+0.3%)	2.8 kB	no change
`sdk`	108.1 kB	+126 B (+0.1%)	755 B	no change
`rsbuild-plugin`	120.0 kB	+40 B (+0.0%)	91 B	no change

Total dist: 6.39 MB (+7.2 kB (+0.1%))
Total ESM gzip: 79.5 kB (+277 B (+0.3%))

…ederation-importmaps-556d

ScriptedAlchemy · 2026-02-09T12:29:35Z

@cursor need import maps support for shared modules as well.

cursor · 2026-02-09T12:29:42Z

Thanks for the request — we can add import‑map support for shared modules too.

Today runtime‑core already lets you do it manually by providing a get that calls import('specifier'), so bare specifiers resolve via import maps. But I can make it first‑class so you don’t have to hand‑write get.

Proposed approach (small, explicit API):

Extend runtime‑core shared args with an optional import (or importSpec) field.
When import is provided, runtime‑core auto‑builds get: () => import(/* webpackIgnore */ import).
If import is a bare specifier, it will resolve via your import map.
Guard the logic behind FEDERATION_OPTIMIZE_NO_IMPORTMAP (same as remotes) so it can be tree‑shaken.

Example target API:

shared: {
  react: {
    import: 'react',
    version: '18.3.1',
    shareConfig: { singleton: true },
  },
}

Before I implement, can you confirm:

Is import the shape you want, or should it be importSpec/importMap?
Do you want this only in runtime‑core (manual runtime usage), or also via the build plugins’ shared config?

Once I have that, I’ll add the runtime support + tests and update docs.

Explicitly type the dynamic import helper to keep the Rollup TS build strict. Co-authored-by: Cursor <cursoragent@cursor.com>

…ederation-importmaps-556d

pkg-pr-new · 2026-02-14T20:06:42Z

Open in StackBlitz

@module-federation/devtools

pnpm add https://pkg.pr.new/@module-federation/devtools@86f0ea9

@module-federation/cli

pnpm add https://pkg.pr.new/@module-federation/cli@86f0ea9

create-module-federation

pnpm add https://pkg.pr.new/create-module-federation@86f0ea9

@module-federation/data-prefetch

pnpm add https://pkg.pr.new/@module-federation/data-prefetch@86f0ea9

@module-federation/dts-plugin

pnpm add https://pkg.pr.new/@module-federation/dts-plugin@86f0ea9

@module-federation/enhanced

pnpm add https://pkg.pr.new/@module-federation/enhanced@86f0ea9

@module-federation/error-codes

pnpm add https://pkg.pr.new/@module-federation/error-codes@86f0ea9

@module-federation/esbuild

pnpm add https://pkg.pr.new/@module-federation/esbuild@86f0ea9

@module-federation/managers

pnpm add https://pkg.pr.new/@module-federation/managers@86f0ea9

@module-federation/manifest

pnpm add https://pkg.pr.new/@module-federation/manifest@86f0ea9

@module-federation/metro

pnpm add https://pkg.pr.new/@module-federation/metro@86f0ea9

@module-federation/metro-plugin-rnc-cli

pnpm add https://pkg.pr.new/@module-federation/metro-plugin-rnc-cli@86f0ea9

@module-federation/metro-plugin-rnef

pnpm add https://pkg.pr.new/@module-federation/metro-plugin-rnef@86f0ea9

@module-federation/modern-js

pnpm add https://pkg.pr.new/@module-federation/modern-js@86f0ea9

@module-federation/modern-js-v3

pnpm add https://pkg.pr.new/@module-federation/modern-js-v3@86f0ea9

@module-federation/native-federation-tests

pnpm add https://pkg.pr.new/@module-federation/native-federation-tests@86f0ea9

@module-federation/native-federation-typescript

pnpm add https://pkg.pr.new/@module-federation/native-federation-typescript@86f0ea9

@module-federation/nextjs-mf

pnpm add https://pkg.pr.new/@module-federation/nextjs-mf@86f0ea9

@module-federation/node

pnpm add https://pkg.pr.new/@module-federation/node@86f0ea9

@module-federation/retry-plugin

pnpm add https://pkg.pr.new/@module-federation/retry-plugin@86f0ea9

@module-federation/rsbuild-plugin

pnpm add https://pkg.pr.new/@module-federation/rsbuild-plugin@86f0ea9

@module-federation/rspack

pnpm add https://pkg.pr.new/@module-federation/rspack@86f0ea9

@module-federation/rspress-plugin

pnpm add https://pkg.pr.new/@module-federation/rspress-plugin@86f0ea9

@module-federation/runtime

pnpm add https://pkg.pr.new/@module-federation/runtime@86f0ea9

@module-federation/runtime-core

pnpm add https://pkg.pr.new/@module-federation/runtime-core@86f0ea9

@module-federation/runtime-tools

pnpm add https://pkg.pr.new/@module-federation/runtime-tools@86f0ea9

@module-federation/sdk

pnpm add https://pkg.pr.new/@module-federation/sdk@86f0ea9

@module-federation/storybook-addon

pnpm add https://pkg.pr.new/@module-federation/storybook-addon@86f0ea9

@module-federation/third-party-dts-extractor

pnpm add https://pkg.pr.new/@module-federation/third-party-dts-extractor@86f0ea9

@module-federation/treeshake-frontend

pnpm add https://pkg.pr.new/@module-federation/treeshake-frontend@86f0ea9

@module-federation/treeshake-server

pnpm add https://pkg.pr.new/@module-federation/treeshake-server@86f0ea9

@module-federation/typescript

pnpm add https://pkg.pr.new/@module-federation/typescript@86f0ea9

@module-federation/utilities

pnpm add https://pkg.pr.new/@module-federation/utilities@86f0ea9

@module-federation/webpack-bundler-runtime

pnpm add https://pkg.pr.new/@module-federation/webpack-bundler-runtime@86f0ea9

@module-federation/bridge-react

pnpm add https://pkg.pr.new/@module-federation/bridge-react@86f0ea9

@module-federation/bridge-react-webpack-plugin

pnpm add https://pkg.pr.new/@module-federation/bridge-react-webpack-plugin@86f0ea9

@module-federation/bridge-shared

pnpm add https://pkg.pr.new/@module-federation/bridge-shared@86f0ea9

@module-federation/bridge-vue3

pnpm add https://pkg.pr.new/@module-federation/bridge-vue3@86f0ea9

@module-federation/inject-external-runtime-core-plugin

pnpm add https://pkg.pr.new/@module-federation/inject-external-runtime-core-plugin@86f0ea9

commit: 86f0ea9

github-actions · 2026-02-14T20:13:31Z

Android Release APK for all devices

🔗 Download link.

Note: if the download link expires, please re-run the workflow to generate a new build.

Generated at 2026-02-15T22:33:27.407Z UTC

github-actions · 2026-02-14T20:22:32Z

iOS Release APP for simulators

🔗 Download link.

Note: if the download link expires, please re-run the workflow to generate a new build.

Generated at 2026-02-15T22:35:04.466Z UTC

…ederation-importmaps-556d

Resolve the dts-plugin TYPE-001 failure by correcting package entry paths for workspace dependencies and updating RawSource usage for webpack typings. Co-authored-by: Cursor <cursoragent@cursor.com>

Remove leftover dead config mutation block and close the exported config function so nx format:check can parse the file in CI. Co-authored-by: Cursor <cursoragent@cursor.com>

Restore sdk and error-codes export paths to the filenames emitted by the current build so CI package resolution no longer fails on these branches. Co-authored-by: Cursor <cursoragent@cursor.com>

feat: add import map entry support

0573749

cursoragent added 4 commits February 8, 2026 22:36

docs: add import map optimization flag

4c9e132

docs: document import map optimization

ce7f19c

chore: disable import map in bundle-size config

578bd15

chore: add changeset for import map support

0895e94

cursoragent and others added 5 commits February 9, 2026 00:07

feat: default disable import map in plugins

afe5b54

feat: add import map demo apps

5613323

feat: use script-based build for import map apps

ce45596

chore: drop nx cypress config for import-map app

10578b3

Merge remote-tracking branch 'origin/main' into cursor/runtime-core-f…

ee9d68e

…ederation-importmaps-556d

ScriptedAlchemy changed the title ~~Runtime-core federation importmaps~~ feat(runtime-core): support import map remote entries Feb 9, 2026

github-actions bot added the change: feat label Feb 9, 2026

Merge remote-tracking branch 'origin/main' into cursor/runtime-core-f…

a3d9ed1

…ederation-importmaps-556d

cursoragent and others added 5 commits February 9, 2026 13:56

feat: support shared import specifiers

343be8b

fix(runtime-core): avoid implicit any in importmap getter

bbc68a2

Explicitly type the dynamic import helper to keep the Rollup TS build strict. Co-authored-by: Cursor <cursoragent@cursor.com>

Merge remote-tracking branch 'origin/main' into cursor/runtime-core-f…

fc8d9eb

…ederation-importmaps-556d

chore(core): add changeset coverage for pr #4390

ad9a9f4

chore(runtime-core): remove redundant auto changeset

02b682f

ScriptedAlchemy changed the title ~~feat(runtime-core): support import map remote entries~~ feat(runtime-core): add import-map remote entry support Feb 12, 2026

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

9ad3668

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

62aca2a

ScriptedAlchemy and others added 22 commits February 15, 2026 13:41

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

b0c892e

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

c16e603

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

9c88a4c

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

3b8b7cb

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

e05fb33

Merge remote-tracking branch 'origin/main' into cursor/runtime-core-f…

e278538

…ederation-importmaps-556d

fix(dts-plugin): align workspace entrypoints and RawSource typing

324c01b

Resolve the dts-plugin TYPE-001 failure by correcting package entry paths for workspace dependencies and updating RawSource usage for webpack typings. Co-authored-by: Cursor <cursoragent@cursor.com>

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

7c45ef8

fix(bundle-size): restore valid webpack config closure

7fea2f4

Remove leftover dead config mutation block and close the exported config function so nx format:check can parse the file in CI. Co-authored-by: Cursor <cursoragent@cursor.com>

fix(sdk): align package entrypoints with emitted artifacts

8332782

Restore sdk and error-codes export paths to the filenames emitted by the current build so CI package resolution no longer fails on these branches. Co-authored-by: Cursor <cursoragent@cursor.com>

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

75eaa63

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

1d651bf

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

0667f2f

chore: merge main into cursor/runtime-core-federation-importmaps-556d

08bc3bb

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

b575b3d

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

7859277

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

64cd97f

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

e22855d

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

63bf4be

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

076b165

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

148cd34

Merge branch 'main' into cursor/runtime-core-federation-importmaps-556d

0a0c44c

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(runtime-core): add import-map remote entry support#4390

feat(runtime-core): add import-map remote entry support#4390
ScriptedAlchemy wants to merge 40 commits intomainfrom
cursor/runtime-core-federation-importmaps-556d

ScriptedAlchemy commented Feb 8, 2026 •

edited

Loading

Uh oh!

cursor bot commented Feb 8, 2026

Uh oh!

netlify bot commented Feb 8, 2026 •

edited

Loading

Uh oh!

changeset-bot bot commented Feb 8, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 8, 2026 •

edited

Loading

Uh oh!

ScriptedAlchemy commented Feb 9, 2026

Uh oh!

cursor bot commented Feb 9, 2026 •

edited

Loading

Uh oh!

pkg-pr-new bot commented Feb 14, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 14, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 14, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

ScriptedAlchemy commented Feb 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changed Packages

Changesets

Base

Single-PR Review Guide (No Additional PRs)

Suggested Review Order

In-Place Scope Trim Checklist

Uh oh!

cursor bot commented Feb 8, 2026

Uh oh!

netlify bot commented Feb 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for module-federation-docs ready!

Uh oh!

changeset-bot bot commented Feb 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

github-actions bot commented Feb 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Bundle Size Report

Uh oh!

ScriptedAlchemy commented Feb 9, 2026

Uh oh!

cursor bot commented Feb 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pkg-pr-new bot commented Feb 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Feb 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Android Release APK for all devices

Uh oh!

github-actions bot commented Feb 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

iOS Release APP for simulators

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

ScriptedAlchemy commented Feb 8, 2026 •

edited

Loading

netlify bot commented Feb 8, 2026 •

edited

Loading

changeset-bot bot commented Feb 8, 2026 •

edited

Loading

github-actions bot commented Feb 8, 2026 •

edited

Loading

cursor bot commented Feb 9, 2026 •

edited

Loading

pkg-pr-new bot commented Feb 14, 2026 •

edited

Loading

github-actions bot commented Feb 14, 2026 •

edited

Loading

github-actions bot commented Feb 14, 2026 •

edited

Loading